home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / network / netlis13.zip / NETLIST.DOC < prev    next >
Text File  |  1990-06-12  |  42KB  |  1,190 lines
  1.  
  2.     [*]===========================================================[*]
  3.      |                                   |
  4.      |      NETLIST    Concurrent search for NetBIOS network users,  |
  5.      |        1.3             extended network statistics       |
  6.      |     June 1990          & other services           |
  7.      |                                   |
  8.     [*]===========================================================[*]
  9.  
  10.  
  11.              Public domain software
  12.  
  13.  
  14.                by  Adam MIROWSKI
  15.             MIROWSKI@FRECP12.BITNET
  16.             ADAMAINT@FRECP12.BITNET
  17.  
  18.                developed at the
  19.             Ecole Centrale de Paris
  20.                 FRANCE
  21.  
  22.  
  23.  
  24.             =======================
  25.                TABLE of CONTENTS
  26.             =======================
  27.  
  28.  
  29.     INTRODUCTION
  30.     ------------
  31.  
  32.     NETLIST's purpose
  33.     Prerequisites
  34.     New version 1.3 features
  35.     Version 1.2 features
  36.  
  37.  
  38.     USER's GUIDE
  39.     ------------
  40.  
  41.     NETLIST's command line syntax
  42.     Explanation of various fields and entities
  43.     Creating users' database
  44.     NETLIST.DEF, the configuration file
  45.     Examples
  46.     Starting and interrupting NETLIST
  47.     Archive's contents
  48.     Remarks -- Bugs
  49.  
  50.  
  51.     APPENDICES
  52.     ----------
  53.  
  54.     NETSTART.COM
  55.     Ideas for next releases
  56.     Search's principles
  57.     Connection's mechanism
  58.     The author
  59.  
  60.  
  61.  
  62.                 ==============
  63.                  INTRODUCTION
  64.                 ==============
  65.  
  66. __________________
  67. NETLIST's  purpose
  68.  
  69.     NETLIST performs various tests on NetBIOS networks. NetBIOS protocols
  70.     are mainly run on Token-Ring and PC Network hardware, but there are
  71.     implementations over TCP/IP and AppleTalk.
  72.  
  73.     NETLIST can:
  74.  
  75.      -- show current network users, by quickly checking the presence of
  76.     a list of selected users, doing up to 170 tests per second,
  77.  
  78.      -- scan a range of adapters by number, to show connected ones,
  79.  
  80.      -- give extensive information and usage statistics about any adapter
  81.     on the network,
  82.  
  83.      -- give an explanation about NetBIOS return codes.
  84.  
  85.     User's list can be automatically created and later updated. Results
  86.     can be automatically time-stamped and archived.
  87.  
  88.     NETLIST supports two simultaneous LAN adapters.
  89.  
  90. _____________
  91. Prerequisites
  92.  
  93.     Have a working NetBIOS driver
  94.     -----------------------------
  95.  
  96.     All tests are performed at the NetBIOS level of protocols, so in
  97.     order to be detected or tested, the user must have an installed and
  98.     working NetBIOS that could answer NETLIST. The machine on which
  99.     NETLIST is run must have NetBIOS too.
  100.  
  101.     The NetBIOS layer will be active on a machine if one of the following
  102.     network softwares is running:
  103.     -- IBM PC-LAN (Microsoft Network, in MS-Windows 3.0 terminology)
  104.     -- Da Vinci eMAIL
  105.     -- Future Soft DynaComm
  106.     -- Sun Microsystems TOPS    (*)
  107.     -- Novell NetWare        (*)
  108.     -- Microsoft/3Com LAN Manager
  109.     and generally if any NetBIOS based software has been used since the
  110.     boot.
  111.  
  112.     (*)    Netware and TOPS aren't NetBIOS based networking softwares, but
  113.     they can provide NetBIOS services if the respective drivers have
  114.     been loaded. You will only be able to detect people who did that.
  115.  
  116.     TOPS' NetBIOS driver is TNETBIOS.EXE and should be loaded after
  117.     ALAP and PSTACK. You should add the /... parameter on ALAP command
  118.     line.
  119.  
  120.     Netware's driver is NETBIOS.EXE. It should be loaded after IPX.COM
  121.     or after NET?.COM.
  122.  
  123.     IBM's dxmT0mod.sys NetBIOS driver isn't automatically activated on
  124.     adapter opening, except when it opens the adapter itself. So you
  125.     don't have an active NetBIOS layer if after the boot you only
  126.     started:
  127.     -- IBM PC-3270 emulation,
  128.     -- IBM Token-Ring bridge program,
  129.     -- IBM TCP/IP suite of programs,
  130.     -- IBMTOKEN.COM (Brian Fisher's 'Ethernet' packet driver
  131.        for TCP/IP over Token-Ring).
  132.  
  133.     However, running NETLIST will activate your NetBIOS layer after
  134.     the start of the PC-3270 emulation or after the installation of
  135.     IBMTOKEN.COM. NETLIST cannot however activate NetBIOS on remote
  136.     adapters.
  137.  
  138.     To simply start the NetBIOS layer there is NETSTART.COM, that you
  139.     could insert at the end of batch files used to launch non NetBIOS-
  140.     based network applications.
  141.  
  142.     Have a database of users or an momentaneous access to network machines
  143.     ----------------------------------------------------------------------
  144.  
  145.     In order to detect the presence of a user or to test his adapter, you
  146.     have to know either one of the network names declared by his NetBIOS
  147.     network software (for exemple the name PC-LAN has been started with)
  148.     or the permanent identification number of his adapter.
  149.  
  150.     Testing adapter numbers is better than testing names, because an
  151.     adapter number will be present on the network as soon as NetBIOS is
  152.     started, whereas network names can change and depend on the currently
  153.     used software.
  154.  
  155.     The adapter number can be obtained with NETLIST either remotely, from
  156.     an active name or locally, running NETLIST on the machine the adapter
  157.     is installed in.
  158.  
  159.     To create users' database, run REGISTER.BAT from a diskette on each
  160.     machine you want to register. You will be asked to input a few words
  161.     to identify the current machine. See details below.
  162.  
  163. ________________________
  164. New version 1.3 features
  165.  
  166.         Describes remote adapters better...
  167.         -----------------------------------
  168.  
  169.     -- NETLIST shows whether PC-LAN is running on remote adapters.
  170.  
  171.     -- The /X option displays all the names found on adapters during
  172.        a search or in a scan.
  173.  
  174.     -- Adapter status display has been adapted to new NetBIOS drivers.
  175.        Now, it indicates the type of the adapter hardware. Various
  176.        other fields have been changed.
  177.  
  178.         Is easier to use...
  179.         -------------------
  180.  
  181.     -- Configuration files set defaults. No more need for batch files.
  182.  
  183.     -- User's database can be set up with a minimal effort.
  184.  
  185.     -- The /F option has a default argument (NETLIST.NAM). The /S option
  186.        is more intelligent.
  187.  
  188.     -- Now when NETLIST doesn't find a name or an adapter number, it
  189.        clearly indicates how it understood the given input string.
  190.  
  191.     -- Name and adapter number syntaxes are better checked.
  192.  
  193.     -- Now slash syntax for funny chars in names is used as often as
  194.        possible, except when saving screen place is important. No
  195.        slash is put in front of adapter numbers when there is no need
  196.        for it.
  197.  
  198.                 ...and more powerful!
  199.         ---------------------
  200.  
  201.     -- Every command updates the specified or default namefile if /U
  202.        option is specified.
  203.  
  204.     -- The /R [times] options asks to loop the test continuously or
  205.        "times" times.
  206.  
  207.     -- The monitor option (/M) asks NETLIST to both:
  208.      -- clear the screen and start displaying from the top,
  209.      -- display received and transmitted frames instead of adapter
  210.         numbers.
  211.  
  212.     -- Adaptative use of adapter resources will try to recover from
  213.        errors which caused a premature end in the 1.2 version.
  214.  
  215.     -- NETLIST tries to find the right interrupt to use. You can impose
  216.        an interrupt if needed.
  217.  
  218.         Some (small) 1.2 bugs have been fixed:
  219.         --------------------------------------
  220.  
  221.     -- Doesn't display inopportune messages anymore when used with 4DOS,
  222.        the COMMAND.COM replacement.    
  223.     -- Missing newlines in /D option display.
  224.     -- Missing fourth digit in the displayed adapter numbers' range
  225.        (/S option).
  226.     -- Number of available NCBs on remote adapters was +1 than what
  227.        it should be.
  228.     -- Wasn't correctly working from the root directory.
  229.  
  230. ____________________
  231. Version 1.2 features
  232.  
  233.     -- NETLIST can scan a given interval of adapter adresses.
  234.  
  235.     -- It can automatically update the network names and adapters'
  236.        identifiers database, replacing NetBIOS names with adapter
  237.        identifiers.
  238.  
  239.     -- NETLIST can display the full status of any given adapter and
  240.        the status of all sessions on the local one.
  241.  
  242.     -- When NETLIST has to open the adapter, it warns about the additio-
  243.        nal (10 second) delay and gives some feedback by displaying dots
  244.        at 1/2 second intervals during the process.
  245.  
  246.     -- The parameters of the search (speed, precision) can be adjusted
  247.        thro